home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Misc Servers / Zope.exe / README.NT < prev    next >
Encoding:
Text File  |  1998-10-19  |  3.7 KB  |  95 lines
  1. README.NT - one day this will grow up and become a real README file.
  2.  
  3. PCGI 2.0a4 Win32 binary release (alpha 4)  August 10, 1998
  4. contact: jeffbauer@bigfoot.com
  5.  
  6. What is this?
  7.  
  8.     The collection of files below is the first Win32
  9.     release of PCGI, the Persistent CGI wrapper for
  10.     Bobo applications.  For more information about Bobo,
  11.     go to Digital Creations site: http://www.digicool.com
  12.  
  13. Files (in relative order of importance):
  14.  
  15.     pcgi-wrapper.exe    - the main program
  16.     pcgi_publisher.py   - modified to handle both Unix & Win32
  17.     pcgifile.py         - indispensible for tracking down problems
  18.     pcgitime.py         - sample module
  19.     pcgitest            - sample PCGI info file
  20.     killpcgi.py         - handy for killing the running process
  21.     parseinfo.exe       - used only when necessary  (to view the pcgi
  22.                             info file the way pcgi-wrapper sees it)
  23.  
  24. For information about Persistent CGI, check out:
  25.  
  26.   http://starship.skyport.net/crew/jbauer/persistcgi/
  27.  
  28.   (This information may soon move over to www.digicool.com)
  29.  
  30. Platforms tested?
  31.  
  32.     Apache/Win32 1.3.1 running on NT 4.0.  However, it should
  33.     run on any Win32 platform running a server supporting http.
  34.  
  35. Basic checklist to get the sample application up and running:
  36.  
  37.     0.  Install Python, Bobo, and a web server on your machine.
  38.         If you haven't got these things already working, please
  39.         see my notes on the subject:
  40.  
  41.           http://starship.skyport.net/crew/jbauer/apachenotes/
  42.  
  43.     1.  Put pcgi-wrapper.exe where you normally place your
  44.         binary executables, or in cgi-bin.
  45.  
  46.     2.  Put pcgi_publisher.py in a directory where you normally
  47.         put your .py scripts -- cgi-bin is okay, but you will
  48.         specify the path in your info file, regardless.
  49.  
  50.     3.  Put pcgitest & pcgitime.py in cgi-bin.  You will have
  51.         to modify the first #! she-bang line in pcgitest to
  52.         match the path of where you put pcgi-wrapper.exe.  Also,
  53.         all directives must match your environment -- the examples
  54.         included are for illustration purposes only.  Please
  55.         read the online (URL above) PCGI documentation for
  56.         further information.
  57.  
  58.     4.  Run your setup against pcgifile.py, a sanity check
  59.         described in:
  60.  
  61.         http://starship.skyport.net/crew/jbauer/persistcgi/pcgifile/
  62.         http://starship.skyport.net/crew/jbauer/persistcgi/howto
  63.  
  64.     5.  Give me feedback, please:  jeffbauer@bigfoot.com
  65.  
  66. -------------------
  67. Microsoft IIS Notes:
  68.  
  69.     Amos Latteier notes that some web servers, notably Microsoft's IIS,
  70.     cannot deal with the first line in a CGI program like Apache:
  71.  
  72.       #!C:\WINNT\system32\pcgi-wrapper.exe
  73.  
  74.     The solution is to use a .pcgi extension for your info file and create 
  75.     a file association between .pcgi and pcgi-wrapper.exe with an IIS script 
  76.     map registry entry, e.g.:
  77.  
  78.       .pcgi  C:\winnt\system32\pcgi-wrapper.exe  %s
  79.  
  80.     Now info files with the .pcgi extension will execute as cgi
  81.     programs.
  82.  
  83.     [Amos further notes in a posting to the Bobo list:]
  84.  
  85.     IIS 4 by default sends a custom 404 error message which masks 
  86.     Bobo's 404 error information.  This effectively keeps you from 
  87.     seeing what Bobo is trying to tell you about why it is not 
  88.     publishing your object.  To get rid of this annoyance go to 
  89.     the web site properties dialog in the Microsoft Management 
  90.     Console application.  Click on the "Custom Errors" tab.  Choose 
  91.     the 404 error and change it to use "Default" error message. 
  92.  
  93.     Voila, you're back in business, and can read Bobo information in 
  94.     the source of your 404 error messages now.
  95.